Create an image with FLUX.1 Kontext [pro] (legacy, use FLUX.2 [PRO] for editing)

Submits an image creation task with FLUX.1 Kontext [pro]. For image editing, prefer FLUX.2 [PRO] (/flux-2-pro) or FLUX.2 [FLEX] (/flux-2-flex) which are the recommended default models for editing workflows.

POST /v1/flux-kontext-pro

Create an image with FLUX.1 Kontext [pro] (legacy, use FLUX.2 [PRO] for editing)

cURL

curl --request POST \
  --url https://api.bfl.ai/v1/flux-kontext-pro \
  --header 'Content-Type: application/json' \
  --header 'x-key: <api-key>' \
  --data '
{
  "prompt": "ein fantastisches bild",
  "input_image": "<string>",
  "input_image_2": "<string>",
  "input_image_3": "<string>",
  "input_image_4": "<string>",
  "seed": 42,
  "aspect_ratio": "<string>",
  "output_format": "png",
  "webhook_url": "<string>",
  "webhook_secret": "<string>",
  "prompt_upsampling": false,
  "safety_tolerance": 2
}
'

200

{
  "id": "<string>",
  "polling_url": "<string>",
  "cost": 123,
  "input_mp": 123,
  "output_mp": 123
}

Authorizations

x-key · string · header · required

Body

application/json

prompt · string · required

Text prompt for image generation.

Example:

"ein fantastisches bild"

input_image · string | null

Base64 encoded image or URL to use with Kontext.

input_image_2 · string | null

Base64 encoded image or URL to use with Kontext. Experimental Multiref

input_image_3 · string | null

Base64 encoded image or URL to use with Kontext. Experimental Multiref

input_image_4 · string | null

Base64 encoded image or URL to use with Kontext. Experimental Multiref

seed · integer | null

Optional seed for reproducibility.

Example:

42

aspect_ratio · string | null

Aspect ratio of the image between 21:9 and 9:21

output_format · enum<string> | null · default: png

Output format for the generated image. Can be 'jpeg', 'png', or 'webp'.

Available options: jpeg, png, webp

webhook_url · string<uri> | null

URL to receive webhook notifications

Required string length: 1 - 2083

webhook_secret · string | null

Optional secret for webhook signature verification

prompt_upsampling · boolean · default: false

Whether to perform upsampling on the prompt. If active, automatically modifies the prompt for more creative generation.

safety_tolerance · integer · default: 2

Tolerance level for input and output moderation. Between 0 and 6, 0 being most strict, 6 being least strict.

Required range: 0 <= x <= 6

Example:

2

Response

200

application/json

Successful Response

AsyncResponse

AsyncWebhookResponse

id · string · required

polling_url · string · required

cost · number | null

Cost in credits for this request

input_mp · number | null

Input megapixels (2 decimal places)

output_mp · number | null

Output megapixels (2 decimal places)